ATAN2-Baustein

Kurz-Information

Name	`ATAN2`
→POE-Typ	→Funktion
Kategorie	Standard (safe), Numeric
Konform zur →IEC-Norm	keine Einschränkungen
Grafische Schnittstelle
Verfügbar ab	Version 1.18.0 (für Neuron Power Engineer) – Anfangsvariante: Eingänge `IN1` und `IN2` Version 1.58.0 (für Neuron Power Engineer) – Erweiterung: Namen der Eingänge auf `Y` und `X` geändert Version 3.1.0 (für Bibliothek `Standard`) – Für Eingänge vom Datentyp `REAL` wird die optimierte `float`-Variante der C-Runtime verwendet. Im Vergleich zu früheren Versionen können in den Grenzwertbereichen des Bausteins (geringfügig) andere Ergebnisse geliefert werden. Version 3.8.0 (für Bibliothek `Standard (safe)`): Baustein in diese Bibliothek verschoben

Funktionalität

Die Winkelfunktion arctan wird aufgerufen: Der Baustein berechnet den Arkustangens mit 2 Parametern. Im Gegensatz zum ATAN-Baustein beachtet dieser Baustein die Vorzeichen beider Parameter und bestimmt so den Quadranten des Ergebnisses.

Der Ergebniswert des Bausteins ist der Winkel in der kartesischen Ebene zwischen der X-Achse und einem vom Ursprung (0,0) zum Punkt (X,Y) zeigenden Vektor. Der Baustein liefert das Ergebnis im Bogenmaß im Bereich von -PI bis +PI (inklusive). Für Winkel entgegen dem Uhrzeigersinn ergeben sich positive Winkel (obere Halbebene, Y > 0), für Winkel im Uhrzeigersinn negative Winkel (untere Halbebene, Y < 0).

Eingänge, Ergebniswert

	Bezeichner	→Datentyp	Beschreibung
Eingänge:	`Y`	`REAL`, `LREAL` (entspricht dem →allgemeinen Datentyp `ANY_REAL`)	Y-Koordinate
Eingänge:	`X`	`REAL`, `LREAL` (entspricht dem →allgemeinen Datentyp `ANY_REAL`)	X-Koordinate
Ergebniswert:	–	`REAL`, `LREAL` (entspricht dem →allgemeinen Datentyp `ANY_REAL`)

Der Eingang EN und der Ausgang ENO sind für den →Aufruf des Bausteins verfügbar. Siehe "Ausführungssteuerung: EN, ENO" für Informationen zum Eingang EN und zum Ausgang ENO.

Informieren Sie sich unter:

"Bausteine für sichere Logik", ob dieser Baustein für das Entwickeln von sicherheitsrelevanten Anwendungen unterstützt wird.
"Kennzeichnung von sicherer Logik im FBS-Editor", welche Auswirkung die Verwendung des Bausteins als Baustein für sichere Logik hat.

Beispiel für Verwendung im ST-Editor

PROGRAM Test

VAR

      result : REAL;

   END_VAR

   result := ATAN2(Y := 1000.0, X := 50.0);    (* The variable 'result' evaluates to '1.520838'. *)

END_PROGRAM

Bei der Erstellung Ihrer Anwendung im ST-Editor erstellen Sie den Aufruf eines Bausteins, indem Sie den laut Syntax erforderlichen Text eintippen oder die Inhaltshilfe verwenden.